CG147.h

Go to the documentation of this file.

#ifndef _CG147_H
#define _CG147_H
/*
 **************************************************************
 * Defines, Macros and Typedefs 
 **************************************************************/
/*** Constant Macros ***/
/* Default Yes and No defines */
#ifndef TRUE
 #define TRUE (1u)
#endif
#ifndef CLEAR
 #define CLEAR (0u)
#endif
#ifndef BITS_IN_NIBBLE
 #define BITS_IN_NIBBLE (4u)
#endif
#ifndef BITS_IN_16
 #define BITS_IN_16 (16u)
#endif
#ifndef BITS_IN_BYTE
 #define BITS_IN_BYTE (8u)
#endif
#ifndef BYTES_IN_16
 #define BYTES_IN_16  (2u)
#endif
#ifndef BYTES_IN_32
 #define BYTES_IN_32  (4u)
#endif

#ifndef BIT_DEFINITION
 #define BIT_DEFINITION
 #define BIT0  (1u << 0u)
 #define BIT1  (1u << 1u)
 #define BIT2  (1u << 2u)
 #define BIT3  (1u << 3u)
 #define BIT4  (1u << 4u)
 #define BIT5  (1u << 5u)
 #define BIT6  (1u << 6u)
 #define BIT7  (1u << 7u)
 #define BIT8  (1u << 8u)
 #define BIT9  (1u << 9u)
 #define BIT10 (1u << 10)
 #define BIT11 (1u << 11)
 #define BIT12 (1u << 12)
 #define BIT13 (1u << 13)
 #define BIT14 (1u << 14)
 #define BIT15 (1u << 15)
 #define BIT16 (1u << 16)
 #define BIT17 (1u << 17)
 #define BIT18 (1u << 18)
 #define BIT19 (1u << 19)
 #define BIT20 (1u << 20)
 #define BIT21 (1u << 21)
 #define BIT22 (1u << 22)
 #define BIT23 (1u << 23)
 #define BIT24 (1u << 24)
 #define BIT25 (1u << 25)
 #define BIT26 (1u << 26)
 #define BIT27 (1u << 27)
 #define BIT28 (1u << 28)
 #define BIT29 (1u << 29)
 #define BIT30 (1u << 30)
 #define BIT31 (1u << 31)
#endif

/* Masks for SPI input data */
#define CG147_TRANSFER_FAILURE_FLAG   ((uint16_t)BIT15)
#define CG147_TEST_ACTIVE_FLAG        ((uint16_t)BIT14)
#define CG147_END_OF_PROGRAMMING_FLAG ((uint16_t)BIT13)

#define CG147_AD_BUSY_FLAG            ((uint16_t)BIT11)
#define CG147_WATCHDOG_FAULT_FLAG     ((uint16_t)BIT10)
#define CG147_DISPOSAL_FLAG_1         ((uint16_t)BIT9)
#define CG147_DISPOSAL_FLAG_2         ((uint16_t)BIT8)
/* Number of ADC samples to be but in an array (think test) */
/* Almost 2 msec of data @ 17usec per sample */
#define CG147_N_ADC_DATA              ((uint16_t)20) 

/* Extended Format */
#define CG147_SAFETY_ID2              ((uint16_t)BIT12)
#define CG147_SAFETY_ID1              ((uint16_t)BIT11)
#define CG147_SAFETY_ID0              ((uint16_t)BIT10)

/* CG147 Valid GENERAL instructions */
#define SBC_READ_DEV_ID       ((uint8_t)0x01u)
#define SBC_READ_REV_ID       ((uint8_t)0x07u)
#define SBC_READ_MON_ID       ((uint8_t)0x02u)
#define SBC_WD2_TRIGGER       ((uint8_t)0x08u)
#define SBC_WD3_TRIGGER       ((uint8_t)0x0Bu)
#define SBC_READ_WD_STATUS    ((uint8_t)0x04u)
#define SBC_READ_WD_FC        ((uint8_t)0x0Eu)
#define SBC_EOP               ((uint8_t)0x0Du)
#define SBC_PSI_SUPPLY        ((uint8_t)0x10u)
#define SBC_FLM_STATUS        ((uint8_t)0x13u)
#define SBC_END_ENABLE        ((uint8_t)0x15u)
#define SBC_SET_I_AIO         ((uint8_t)0x16u)
#define SBC_READ_THRES        ((uint8_t)0x19u)
#define SBC_SET_I_LIN         ((uint8_t)0x1Au)
#define SBC_START_ADC         ((uint8_t)0x1Cu)
#define SBC_READ_ADC          ((uint8_t)0x1Fu)
#define SBC_TEST_ANA_HEAD     ((uint8_t)0x20u)
#define SBC_POWER_CTRL        ((uint8_t)0x23u)
#define SBC_POWER_STATUS      ((uint8_t)0x25u)
#define SBC_AOUT_CTRL         ((uint8_t)0x26u)
#define SBC_HS_ON1_4          ((uint8_t)0x29u)
#define SBC_HS_ON5_8          ((uint8_t)0x2Au)
#define SBC_HS_ON9_12         ((uint8_t)0x2Cu)
#define SBC_FLM_TEST_SRC      ((uint8_t)0x2Fu)
#define SBC_LS_ON1_4          ((uint8_t)0x31u)
#define SBC_LS_ON5_8          ((uint8_t)0x32u)
#define SBC_LS_ON9_12         ((uint8_t)0x34u)
#define SBC_FLM_TEST_SINK     ((uint8_t)0x37u)
#define SBC_FLM_LOCK          ((uint8_t)0x3Bu)
#define SBC_LOWLEAK           ((uint8_t)0x3Du)
#define SBC_FIRE_COUNTER      ((uint8_t)0x3Eu)
#define SBC_READ_PSI          ((uint8_t)0x80u)
#define SBC_SELECT_PSI        ((uint8_t)0xC2u)
#define SBC_DISPOSAL          ((uint8_t)0xC4u)
#define SBC_SET_AIO_PWM       ((uint8_t)0xFEu)
#define SBC_DEMAND_TEST       ((uint8_t)0x38u)
#define SBC_THRES_TEST_DATA   ((uint8_t)0xC8u)
#define SBC_THRES_TEST_SID    ((uint8_t)0xCBu)
#define SBC_ENABLE_PROG       ((uint8_t)0xCDu)
#define SBC_SET_MM5_MODE      ((uint8_t)0xCEu)
#define SBC_PSI_SYNC_GEN      ((uint8_t)0xF2u)
#define SBC_PSI_SYNC_MASK     ((uint8_t)0xF4u)
#define SBC_AIO_STATUS        ((uint8_t)0xF8u)
#define SBC_SET_PSI_IPP       ((uint8_t)0xDAu)
#define SBC_READ_PSI_IPP      ((uint8_t)0xD3u)
#define SBC_PSI_IQ_STATUS     ((uint8_t)0xD5u)
#define SBC_CLEAR_FIRE_CNT    ((uint8_t)0xD6u)
#define SBC_SID_EVALUATE      ((uint8_t)0xD9u)
#define SBC_TEST_PSI_CONS     ((uint8_t)0xDCu)

/* CG147 Valid PROGRAMMING instructions */
#define SBC_PROG_GENERAL      ((uint8_t)0x40u)
#define SBC_PROG_UP_THRES     ((uint8_t)0x43u)
#define SBC_PROG_LOW_THRES    ((uint8_t)0x45u)
#define SBC_PROG_AIN1_2       ((uint8_t)0x49u)
#define SBC_PROG_AIN3_4       ((uint8_t)0x4Au)
#define SBC_PROG_AIN5_6       ((uint8_t)0x4Cu)
#define SBC_PROG_AIO_WL       ((uint8_t)0x79u)
#define SBC_PROG_PSI1_LINE    ((uint8_t)0x4Fu)
#define SBC_PROG_PSI2_LINE    ((uint8_t)0x51u)
#define SBC_PROG_PSI3_LINE    ((uint8_t)0x52u)
#define SBC_PROG_PSI4_LINE    ((uint8_t)0x54u)
#define SBC_PROG_UFS_THRES    ((uint8_t)0x57u)
#define SBC_PROG_PAS_THRES    ((uint8_t)0x58u)
#define SBC_PROG_PRES_THRES   ((uint8_t)0x5Bu)
#define SBC_PROG_ROLL_THRES   ((uint8_t)0x5Du)
#define SBC_PROG_X_THRES      ((uint8_t)0x5Eu)
#define SBC_PROG_Y_THRES      ((uint8_t)0x61u)
#define SBC_PROG_POWER        ((uint8_t)0x62u)
#define SBC_PROG_FLM_ENH      ((uint8_t)0x64u)
#define SBC_PROG_SDIS1_4      ((uint8_t)0x67u)
#define SBC_PROG_SDIS5_8      ((uint8_t)0x68u)
#define SBC_PROG_SDIS9_12     ((uint8_t)0x6Bu)
#define SBC_PROG_DISXY1_4     ((uint8_t)0x6Du)
#define SBC_PROG_DISXY5_8     ((uint8_t)0x6Eu)
#define SBC_PROG_DISXY9_12    ((uint8_t)0x70u)
#define SBC_PROG_FLM_CONF     ((uint8_t)0x73u)
#define SBC_PROG_PSYNC_MODE   ((uint8_t)0x75u)
#define SBC_PROG_SDIS_CH      ((uint8_t)0x7Au)
#define SBC_PROG_PSI_SID      ((uint8_t)0x76u)
#define SBC_PROG_MM5_SID      ((uint8_t)0x7Fu)
#define SBC_PROG_ENH_SAFETY   ((uint8_t)0x46u)

/* AOUT Channels */
#define SBC_AOUT_VSTT33_DIV_2 ((uint8_t)0x00u)
#define SBC_AOUT_VSTT50_DIV_2 ((uint8_t)0x01u)
#define SBC_AOUT_TEMP_DIODE   ((uint8_t)0x02u)
#define SBC_AOUT_VAS_SET      ((uint8_t)0x03u)
#define SBC_AOUT_AGND         ((uint8_t)0x04u)
#define SBC_AOUT_SQREF        ((uint8_t)0x05u)
#define SBC_AOUT_AVST33       ((uint8_t)0x06u)
#define SBC_AOUT_VSYNC_DIV_8  ((uint8_t)0x07u)
#define SBC_AOUT_PSI1_DIV_6   ((uint8_t)0x08u)
#define SBC_AOUT_PSI2_DIV_6   ((uint8_t)0x09u)
#define SBC_AOUT_PSI3_DIV_6   ((uint8_t)0x0Au)
#define SBC_AOUT_PSI4_DIV_6   ((uint8_t)0x0Bu)
#define SBC_AOUT_VDN_DIV_146  ((uint8_t)0x0Du)
#define SBC_AOUT_IGH1         ((uint8_t)0x10u)
#define SBC_AOUT_IGH2         ((uint8_t)0x11u)
#define SBC_AOUT_IGH3         ((uint8_t)0x12u)
#define SBC_AOUT_IGH4         ((uint8_t)0x13u)
#define SBC_AOUT_IGL1         ((uint8_t)0x14u)
#define SBC_AOUT_IGL2         ((uint8_t)0x15u)
#define SBC_AOUT_IGL3         ((uint8_t)0x16u)
#define SBC_AOUT_IGL4         ((uint8_t)0x17u)
#define SBC_AOUT_ER1_DIV_10   ((uint8_t)0x18u)
#define SBC_AOUT_ER2_DIV_10   ((uint8_t)0x19u)
#define SBC_AOUT_IGH5         ((uint8_t)0x20u)
#define SBC_AOUT_IGH6         ((uint8_t)0x21u)
#define SBC_AOUT_IGH7         ((uint8_t)0x22u)
#define SBC_AOUT_IGH8         ((uint8_t)0x23u)
#define SBC_AOUT_IGL5         ((uint8_t)0x24u)
#define SBC_AOUT_IGL6         ((uint8_t)0x25u)
#define SBC_AOUT_IGL7         ((uint8_t)0x26u)
#define SBC_AOUT_IGL8         ((uint8_t)0x27u)
#define SBC_AOUT_ER3_DIV_10   ((uint8_t)0x28u)
#define SBC_AOUT_ER4_DIV_10   ((uint8_t)0x29u)
#define SBC_AOUT_IGH9         ((uint8_t)0x30u)
#define SBC_AOUT_IGH10        ((uint8_t)0x31u)
#define SBC_AOUT_IGH11        ((uint8_t)0x32u)
#define SBC_AOUT_IGH12        ((uint8_t)0x33u)
#define SBC_AOUT_IGL9         ((uint8_t)0x34u)
#define SBC_AOUT_IGL10        ((uint8_t)0x35u)
#define SBC_AOUT_IGL11        ((uint8_t)0x36u)
#define SBC_AOUT_IGL12        ((uint8_t)0x37u)
#define SBC_AOUT_ER5_DIV_10   ((uint8_t)0x38u)
#define SBC_AOUT_ER6_DIV_10   ((uint8_t)0x39u)

/* Watch-dog messages */
#define SBC_WD_CHECKWORD_1 ((uint8_t)0x20)
#define SBC_WD_CHECKWORD_2 ((uint8_t)0xFD)
#define SBC_WD_CHECKWORD_3 ((uint8_t)0x8A)
#define SBC_WD_CHECKWORD_4 ((uint8_t)0x57)
#define SBC_WD_CHECKWORD_5 ((uint8_t)0xEC)
#define SBC_WD_CHECKWORD_6 ((uint8_t)0x31)
#define SBC_WD_CHECKWORD_7 ((uint8_t)0x46)
#define SBC_WD_CHECKWORD_8 ((uint8_t)0x9B)
#define SBC_WD_RESPONSE_1  ((uint8_t)0x19)
#define SBC_WD_RESPONSE_2  ((uint8_t)0x6E)
#define SBC_WD_RESPONSE_3  ((uint8_t)0xB3)
#define SBC_WD_RESPONSE_4  ((uint8_t)0xC4)
#define SBC_WD_RESPONSE_5  ((uint8_t)0x2A)
#define SBC_WD_RESPONSE_6  ((uint8_t)0x5D)
#define SBC_WD_RESPONSE_7  ((uint8_t)0x80)
#define SBC_WD_RESPONSE_8  ((uint8_t)0xF7)

/* Error messages */
#define CG147_TRANSCIEVE_ERROR ((uint8_t)0x80u)
#define CG147_PIT_CONFIG_ERROR ((uint8_t)0x40u)
#define CG147_RESPONSE_PARITY_FAILURE ((uint8_t)0x01u)

/* Predefined sizes */
#define CG147_INPUT_BUFFER_SIZE  ((uint8_t)30u)

/* Masks */
#define CG147_RESPONSE_STATUS_BYTE_MASK (0xFFu)
#define CG147_ACCEL_STATUS_BYTE_MASK    (0xE0u)
#define CG147_ACCEL_READING_MASK        (0x03u)
#define CG147_UNLOCK_HS_LS              (0x05u)
#define CG147_ALL_AIRBAG_MASK           (0xFFFu)

#define CG147_SQUIB_FIRE_OFFSET        (1u)
#define CG147_TEST_CMD_SIZE_FIRST_PART (2u)
#define CG147_TEST_CMD_SIZE_SECOND_PART (N_ELEMENTS(cau8CG147TestCmds) \
                                         - CG147_TEST_CMD_SIZE_FIRST_PART)
/* Test modes */
#define CG147_TEST_IS_VER_ESR          (0x03u)
#define CG147_TEST_IS_VER_CAP          (0x05u)
#define CG147_TEST_IS_POL_PROT         (0x09u)

/* ADC test Voltages */
#define SBC_AINADC_VAS_SET          ((uint8_t)0x10u)
#define SBC_AINADC_REF_BG           ((uint8_t)0x11u)
#define SBC_AINADC_REF_BG2          ((uint8_t)0x12u)
#define SBC_AINADC_23REF_BG2        ((uint8_t)0x13u)
#define SBC_AINADC_AGND             ((uint8_t)0x14u)
#define SBC_AINMUX_NO_SWITCHES      ((uint8_t)0x0Fu)

/* MUX test channels */
#define SBC_AINMUX_VOLT             (0x0Fu)
#define SBC_AINMUX_AIN1             (0x00u)
#define SBC_AINMUX_AIN2             (0x01u)
#define SBC_AINMUX_AIN3             (0x02u)
#define SBC_AINMUX_AIN4             (0x03u)
#define SBC_AINMUX_AIN5             (0x04u)
#define SBC_AINMUX_AIN6             (0x05u)
#define SBC_AINMUX_AIO1             (0x06u)
#define SBC_AINMUX_AIO2             (0x07u)

/* Number of ER channels */
#define CG147_N_ER_LINES  (6u)

/* This define is used to set the default power setting in SBC_POWER_CTRL */
#define CG147_DEFAULT_POWER_STG  0x10u

/* Using SPI word transfers as timer */
#define CG147_SPI_FAKE_TIME_20US        (uint16_t)((20/(3.93)) + 1u)
#define CG147_SPI_FAKE_TIME_50US        (uint16_t)((50/(3.93)) + 1u)

/* Timing elements */
#define CG147_TIME_DIVIDER           (500000)
#define CG147_PULSE_DELAY_40_USEC    (PIT_1_SEC / CG147_TIME_DIVIDER), \
                                      (uint16_t)(0.00004 * CG147_TIME_DIVIDER)
#define CG147_PULSE_DELAY_20_USEC    (PIT_1_SEC / CG147_TIME_DIVIDER), \
                                      (uint16_t)(0.00002 * CG147_TIME_DIVIDER)
#define CG147_WD2_COUNT_FOR_ISR      ((uint16_t)SCHED_500US_PERIOD)
#define CG147_WD3_COUNT_FOR_ISR      ((uint8_t)180u)

#define SIGN_10_BITS                 ((uint16_t)BIT9)
#define MAX_VALUE_10_BITS            ((uint16_t)0x3FFu)

#define CG147_SAT_MASK_MAX           ((uint16_t)BIT12)
#define CG147_SAT_MASK_MIN           ((uint16_t)BIT0)

#define CG147_LONG_TEST_WAIT_MS      ((uint16_t)187u)

/*** Function Macros ***/
#ifndef N_ELEMENTS
 #define N_ELEMENTS(X)           (sizeof(X)/sizeof(*(X)))
#endif

#define CG147_AIRBAG_MASK(XX) XX
/*** Enums ***/


/*** TypeDefs ***/

/*
 **************************************************************
 * Declarations 
 **************************************************************/
/*** Extern ***/
extern const uint16_t cau16CG147InitCmdsArgs[];
extern const uint8_t cu8CG147InitCmdsArgsSize;
extern const uint8_t cau8CG147InitCmdsIn16Bit[];
extern const uint8_t cau8CG147InitArgsIn16Bit[];
/*** Globals ***/
/* Following global variable is used by this driver to store whatever the */
/* CG147 is sending back                                                  */
extern uint16_t gau16CG147Responses[CG147_INPUT_BUFFER_SIZE];
extern uint8_t  gau8CG147DSPIComplexInstances[];
extern uint8_t gu8CG147WatchDog2ResponseFromMCU;
extern uint8_t gu8CG147WatchDog3ResponseFromMCU;
extern uint32_t gu32CG147WatchDog2RequestToMCU;
extern uint32_t gu32CG147WatchDog3RequestToMCU;
extern uint16_t gu16CG147WatchDog2IsrCount;
extern uint16_t gu16CG147WatchDog3IsrCount;

/*** Static Globals ***/

/*
 **************************************************************
 * Function Prototypes 
 **************************************************************/
/************** Non-scheduler, 16-bit legacy fns follow ***************/ 
/*
 ******************************************************************************
 *
 * Function:          vfnCG147Init()
 *
 */
void vfnCG147Init(const uint8_t cu8DSPIMainInstance, 
                  const uint8_t cu8ChipSelect,
                  const uint8_t cu8DSPISecondaryInstance1,
                  const uint8_t cu8DSPISecondaryInstance2, 
                  const uint8_t cu8NSysResPort, 
                  const uint8_t cu8NSysResPin);
/*
 ******************************************************************************
 *
 * Function:          vfnCG147ToggleResetPin()
 *
 */
void vfnCG147ToggleResetPin(const uint8_t cu8State,
                            const uint8_t cu8NSysResPort,
                            const uint8_t cu8NSysResPin);
/*
 ******************************************************************************
 *
 * Function:          u8fnCG147ReadAOut()
 *
 */
uint8_t u8fnCG147ReadAOut(const uint8_t cu8DSPIInstance,
                          const uint8_t cu8ChipSelect, 
                          const uint8_t cu8ADCInstance,
                          const uint8_t cu8ADCCh, 
                          const uint8_t cu8CG147Ch, 
                          uint16_t* pu16Result);
/*
 ******************************************************************************
 *
 * Function:          u8fnCG147ReadPSI5Accel()
 *
 */
uint8_t u8fnCG147ReadPSI5Accel(const uint8_t cu8DSPIInstance,
                               const uint8_t cu8ChipSelect,
                               uint16_t* pu16Accel);
/*
 ******************************************************************************
 *
 * Function:          u8fnCG147ReadPSI5RegSensor()
 *
 */
uint8_t u8fnCG147ReadPSI5RegSensor(const uint8_t cu8DSPIInstance, \
                                   const uint8_t cu8ChipSelect, \
                                   uint16_t* pu16Accel);
/*
 ******************************************************************************
 *
 * Function:          u8fnCG147Transcieve()
 *
 */
vuint8_t u8fnCG147Transcieve(uint8_t u8Cmd, uint8_t u8Value,
                             uint8_t u8SPIInstance, uint8_t u8CSToCG147);
/*
 ******************************************************************************
 *
 * Function:          u8fnCG147BatchTranscieve()
 *
 */
uint8_t u8fnCG147BatchTranscieve(uint8_t* pu8Cmd, uint8_t* pu8Value,
                                 uint8_t u8SPIInstance, uint8_t u8CSToCG147,
                                 uint8_t u8NOfMessages);
/*********************** 16-bit scheduled fns follow **************************/
/*
 ******************************************************************************
 *
 * Function:          u8fnCG147ScheduleAOut()
 *
 */
uint8_t u8fnCG147ScheduleAOut(const uint8_t cu8DSPIInstance,
                              const uint8_t cu8ChipSelect,
                              const uint8_t cu8CG147Ch, uint16_t* pu16Status,
                              uint32_t* pu32Time);
/*
 ******************************************************************************
 *
 * Function:          u8fnCG147SchedulePSI5Accel()
 *
 */
uint8_t u8fnCG147SchedulePSI5Accel(const uint8_t cu8DSPIInstance,
                                  const uint8_t cu8ChipSelect,
                                  uint16_t* pu16Accel, uint32_t* pu32Time);
/*
 ******************************************************************************
 *
 * Function:          u8fnCG147ScheduleTransfer()
 *
 */
uint8_t u8fnCG147ScheduleTransfer(uint8_t u8SPIInstance, 
                                  uint8_t u8CSToCG147,
                                  uint8_t u8Cmd, uint8_t u8Value,
                                  uint16_t* pu16Response,
                                  uint32_t* pu32RequestTime);
/*
 ******************************************************************************
 *
 * Function:          u8fnCG147ScheduleBatchTransfer()
 *
 */
uint8_t u8fnCG147ScheduleBatchTransfer(uint8_t u8SPIInstance,
                                      uint8_t u8CSToCG147, uint8_t* pu8Cmd,
                                      uint8_t* pu8Value,
                                      uint16_t* pu16Response, uint8_t u8Size,
                                      uint32_t* pu32RequestTime);
/*********************** 17-bit scheduled fns follow **************************/
/*
 ******************************************************************************
 *
 * Function:          u8fnCG147ScheduleSafeAOut()
 *
 */
uint8_t u8fnCG147ScheduleSafeAOut(const uint8_t cu8DSPIInstance1,
                                  const uint8_t cu8DSPIInstance2,  
                                  const uint8_t cu8ChipSelect,
                                  const uint8_t cu8CG147Ch, 
                                  uint32_t* pu32Status,
                                  uint32_t* pu32Time);
/*
 ******************************************************************************
 *
 * Function:          u8fnCG147ScheduleSafePSI5Accel()
 *
 */
uint8_t u8fnCG147ScheduleSafePSI5Accel(const uint8_t cu8DSPIInstance1,
                                       const uint8_t cu8DSPIInstance2,
                                       const uint8_t cu8ChipSelect,
                                       const uint16_t cu16ActiveChannels,
                                       uint32_t* pu32RawAccel,
                                       uint32_t* pu32Time);
/*
 ******************************************************************************
 *
 * Function:          u8fnCG147ScheduleSafeSquibFireStart()
 *
 */
uint8_t u8fnCG147ScheduleSafeSquibFireStart(const uint8_t cu8DSPIInstance1,
                                            const uint8_t cu8DSPIInstance2,
                                            const uint8_t cu8ChipSelect,
                                            uint16_t u16ChannelMask,
                                            uint32_t* pu32Time);
/*
 ******************************************************************************
 *
 * Function:          u8fnCG147ScheduleSafeSquibFireStop()
 *
 */
uint8_t u8fnCG147ScheduleSafeSquibFireStop(const uint8_t cu8DSPIInstance1,
                                           const uint8_t cu8DSPIInstance2,
                                           const uint8_t cu8ChipSelect,
                                           uint32_t* pu32Time);
/*
 ******************************************************************************
 *
 * Function:          u8fnCG147ScheduleSafeTest()
 *
 */
uint8_t u8fnCG147ScheduleSafeTest(const uint8_t cu8DSPIInstance1,
                                  const uint8_t cu8DSPIInstance2,
                                  const uint8_t cu8ChipSelect,
                                  uint8_t u8TestCase,
                                  uint32_t* pu32Result,
                                  uint16_t* pu16ADCResponses,
                                  uint32_t* pu32Time);
/*
 ******************************************************************************
 *
 * Function:          u8fnCG147ScheduleSafeTransfer()
 *
 */
uint8_t u8fnCG147ScheduleSafeTransfer(const uint8_t cu8SPIInstance1,
                                      const uint8_t cu8SPIInstance2,
                                      const uint8_t cu8CSToCG147,
                                      uint8_t u8Cmd, 
                                      uint8_t u8Value,
                                      uint16_t* pu16Response, 
                                      uint32_t* pu32RequestTime);
/*
 ******************************************************************************
 *
 * Function:          u8fnCG147ScheduleSafeBatchTransfer()
 *
 */
uint8_t u8fnCG147ScheduleSafeBatchTransfer(const uint8_t cu8SPIInstance1,
                                           const uint8_t cu8SPIInstance2,
                                           const uint8_t cu8CSToCG147,
                                           uint8_t* pu8Cmd, 
                                           uint8_t* pu8Value,
                                           uint16_t* pu16Response,
                                           uint8_t u8Size,
                                           uint32_t* pu32RequestTime);
/* *************** fns independent of Transfer-mode follow *******************/
/*
 ******************************************************************************
 *
 * Function:          vfnCG147SyncPulse()
 *
 */
void vfnCG147SyncPulse(const uint8_t cu8NSyncPort, const uint8_t cu8NSyncPin);
/*
 ******************************************************************************
 *
 * Function:          u8fnCG147WatchDogStartUp()
 *
 */
uint8_t u8fnCG147WatchDogStartUp(void);
/*
 ******************************************************************************
 *
 * Function:          u8fnCG147WatchDogNextWord()
 *
 */
uint8_t u8fnCG147WatchDogNextWord(const uint8_t u8WordFromSBC);
/*
 ******************************************************************************
 *
 * Function:          vfnCG147ComposeFrame()
 *
 */
void vfnCG147ComposeFrame(uint8_t* pu8Cmd, uint8_t* pu8Value, \
                          uint16_t* pu16ComposedMessage, uint8_t u8Size);
/* ********************** Filter fns follow **********************************/
/*
 ******************************************************************************
 *
 * Function:          u16fnCG147ExtractScheduledPSI5Accel()
 *
 */
uint16_t u16fnCG147ExtractScheduledPSI5Accel(const uint32_t* pu32RawResponse,
                                           uint16_t* pu16Accel, 
                                           const uint16_t u16ChannelsMask);
/*
 ******************************************************************************
 *
 * Function:          u8fnCG147ExtractPSIAccel()
 *
 */
uint8_t u8fnCG147ExtractPSIAccel(const uint32_t* pu32RawResponse,
                                 uint16_t* pu16Accel);
/*
 ******************************************************************************
 *
 * Function:          u8fnCG147ExtractResponse()
 *
 */
uint8_t u8fnCG147ExtractResponse(const uint32_t* pu32RawResponse,
                                 uint8_t* pu8Response);
/*
 ******************************************************************************
 *
 * Function:          u8fnCG147VerifyParityFromSafeResult()
 *
 */
static uint8_t u8fnCG147VerifyParityFromSafeResult(uint32_t u32ComplexResponse);
/*
 ******************************************************************************
 *
 * Function:          u16fn10BitOffsetFilter()
 *
 */
uint16_t u16fn10BitOffsetFilter(uint16_t u16RawValue);
/* ************************* Isr fns follow **********************************/
/*
 ******************************************************************************
 *
 * Function:          vfnCG147WD2Isr()
 *
 */
void vfnCG147WD2Isr(void);
/*
 ******************************************************************************
 *
 * Function:          vfnReScheduleWD()
 *
 */
void vfnReScheduleWD(void);
/*
 ******************************************************************************
 *
 * Function:          vfnReScheduleWD3()
 *
 */
void vfnReScheduleWD3(void);

#endif /* _FILENAME_H */